home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 031a / desutl20.zip / EXITW.DOC < prev    next >
Text File  |  1991-11-29  |  7KB  |  225 lines
  1. ExitW Copyright (c) 1990, 1991 Dragon's Eye Software
  2. Last Updated: 11/20/91
  3.               Version 2.4
  4.  
  5.  
  6. ExitW is a combination of two programs that allow you to exit Windows
  7. quickly and pass data back to DOS so that further processing can be done
  8. after exiting.
  9.  
  10.  
  11.  
  12.  
  13. Version 2.4 of ExitW has been expanded to allow the user to: 
  14.  
  15.  o  Display a message before exiting to DOS that has both an Ok and Cancel
  16.     button so the user can cancel the exit process.
  17.  
  18.  o  Set a specific errorlevel code that should be passed back to DOS.
  19.  
  20.  o  Set a specific DOS environment string to a user entered value.
  21.  
  22.  o  Restart Windows.  This is faster than exiting to DOS and then re-running
  23.     Windows!
  24.  
  25.  
  26.  
  27.                                 HOW TO USE EXITW
  28.  
  29. To use ExitW you should first install the ExitW icon in your Windows shell.
  30. The shell will be either the Program Manager or the program that comes up
  31. first under Windows.
  32.  
  33. Once you have done this, all you have to do to quickly exit to DOS is double
  34. click on this icon.  ExitW will be executed and will tell Windows to shut
  35. down.
  36.  
  37.  
  38.                  USING EXITW PARAMETERS
  39.  
  40. By using the ExitW command line parameters you can tap the real power of
  41. ExitW.
  42.  
  43. The command line parameters can be added to the icon by opening the
  44. File|Properties menu while the icon is selected (when using the Program
  45. Manager.  If you are using another shell, please consult your documentation
  46. for adding command line parameters to an icon).
  47.  
  48.  
  49.              COMMAND LINE PARAMETERS FOR EXITW.EXE
  50.  
  51. The following command line parameters should be used when running ExitW.
  52. Please note that the commands are processed sequentially as they appear on 
  53. the command line and that more than one command can appear on the same line.
  54.  
  55. The command line syntaxt is as follows:
  56.  
  57.   EXITW -[M|E|S|R] <text>
  58.  
  59.  
  60.     COMMANDS             DESCRIPTION
  61.  
  62.   -M <message>
  63.  
  64.     where <message> is a string contained within quotes that you want
  65.     displayed to the user before exiting windows.
  66.     The Messagebox that will be displayed to the user will have
  67.     both Cancel and Ok buttons.  If the user presses Cancel, then
  68.     ExitW will NOT shut down Windows.
  69.     
  70.     Note that quotes are required for the message text to be displayed
  71.     properly if you are using dashes (-) within the display text.
  72.     
  73.     Example: EXITW -M "Now running Autocad - Click on Cancel to abort"
  74.  
  75.     This example will display a message box with an Ok and Cancel button
  76.     that displays the text "Now running Autocad - Click on Cancel to
  77.     abort".     If the user clicks on Ok then Windows will shut down.  If
  78.     the user clicks on Cancel then ExitW will not shut down Windows!
  79.  
  80.     It is intended that this command be used in conjunction with the
  81.     -E command
  82.     
  83.  
  84.   -E <num>
  85.  
  86.     Where <num> is the errorlevel number that should be returned to DOS.
  87.     This number should fall    between 1 and 200 (an errorlevel code of
  88.     200 is used by the ExitWDOS program to indicate a data file error).
  89.  
  90.     Example: EXITW -E 10
  91.  
  92.     This will cause ExitW to write the value "-E 10" to the data file.
  93.     When the data file is processed by ExitWDOS, 10 will be returned as
  94.     an ERRORLEVEL code.
  95.  
  96.  
  97.   -S <string>
  98.  
  99.     where string is an environment variable string that should be added
  100.     to or changed within the set of current MS-DOS environment settings.
  101.     
  102.     An example would be: EXITW -S PATH=C:\;C:\DOS
  103.     
  104.     This will cause ExitW to write the value "C:\;C:\DOS" to the data
  105.     file.    set your path to equal "C:\;C:\DOS" when
  106.     When the data file is processed by ExitWDOS, your PATH environment
  107.     variable will be changed to "C:\;C:\DOS".
  108.  
  109.  
  110.   -R
  111.  
  112.     This command will cause Windows to perform a Restart operation.
  113.     This is functionally the same as exiting to DOS and then re-running
  114.     Windows.
  115.  
  116.     When running large programs in Windows or when running many
  117.     different programs, you may notice that your percentage of free
  118.     resources steadily decreases.  By running ExitW with the -R parameter
  119.     you can restart Windows and regain those lost resources.
  120.  
  121.     *** Note: When this command is used -R should normally be the only
  122.     parameter on the command line.  When ExitW encounters the -R
  123.     parameter, it will immediately restart Windows. Because of this,
  124.     processing that would normally be done in DOS, based on the other
  125.     command line parameters, will not occur becuase    Windows does not
  126.     shut down when this command is used.
  127.  
  128.  
  129. *** If no parameters are given on the ExitW command line then ExitW    ***
  130. *** will not create a data file.  It will merely cause an exit to DOS. ***
  131.  
  132.  
  133.  
  134.  
  135.               WIN.INI ENTRY FOR EXITW.EXE
  136.  
  137.   The following two lines should be present in the WIN.INI file for ExitW
  138.   to operate properly:
  139.  
  140.     [ExitW]
  141.     Filename=<path>
  142.  
  143.  
  144.   where <path> is a full pathname a file where ExitW will store the commmand
  145.   line parameters.  (EG. Filename=C:\WINDOWS\EXITW.DAT).
  146.  
  147.   If this entry is not found, then ExitW will save the parameters to a file
  148.   called EXITW.DAT in the root directory of the current drive.
  149.  
  150.  
  151.   
  152.                     EXAMPLE
  153.  
  154.       Calling ExitW with the following command line:
  155.  
  156.       EXITW -M "Exiting Windows" -S PATH=C:\ -E 1
  157.  
  158.     Would cause ExitW to write to disk the options:
  159.  
  160.       -S PATH=C:\
  161.       -E 1
  162.  
  163.     When ExitWDOS is executed, it will parse the data file created by
  164.     ExitW and change the path to equal "C:\" and will return and errorlevel
  165.     code of 10.
  166.  
  167.  
  168.      **    ExitW is currently in active use on several hundred computers around
  169.         the country.  For a batch file example of one way to use ExitW please
  170.     refer to the WIN.BAT file.
  171.  
  172.  
  173.  
  174. ***** IMPORTANT *****
  175.  
  176. When executing ExitWDOS, you MUST specify the location and name of the file
  177. created by ExitW.  Without this specification, ExitWDOS will not know where
  178. to find the file.
  179.  
  180. For example:
  181.  
  182.   EXITWDOS C:\WINDOWS\EXITW.DAT
  183.  
  184. will cause ExitWDOS to look in the directory \WINDOWS on drive C: for the file
  185. EXITW.DAT.  If this file exists, ExitWDOS will parse the file and return the
  186. information contained within it.
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194. Revision History
  195. ----------------
  196.  
  197. Version 2.4    - 11/20/91
  198.         Added a restart capability.  If -R is on the command line then
  199.     ExitW will restart Windows.
  200.  
  201.  
  202. Version 2.3    - 03/02/91
  203.     Got rid of spurious messages when setting an exit message or
  204.     an errorlevel code.
  205.  
  206.  
  207. Version 2.1    - 01/27/91
  208.     Added a cancel button to the MessageBox and fixed the bug where
  209.     ExitWDOS was adding a space to the end of the environment variables.
  210.     Also changed the code so that dashes "-" may be used within messagebox
  211.     strings.
  212.  
  213.  
  214. Version 2.0    - 01/13/91
  215.     ExitW has been expanded to allow the user to: display a message before
  216.     exiting to DOS, to set the specific errorlevel code that should be
  217.     passed back and to set a specific environment string.
  218.  
  219.  
  220. Version 1.0    - 06/20/90
  221.     Released
  222.  
  223.  
  224.  
  225.